home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / graphics / ms073.lzh / MOLSYS.TXT < prev    next >
Text File  |  1992-06-15  |  39KB  |  731 lines
  1. New features since MolSys v0.68 -----------------------------------------------
  2.  
  3. *    Load and save individual molecule fragments
  4. *    Saves GEM image files
  5. *    MultiSys™     - Up to 8 independent molecule fragments at once
  6.             - Create, copy, join, break and delete fragments
  7.             - Global or individual manipulation and display
  8. *    Set ball and stick size and thickness
  9. *    New atom types    - Ionized oxygen, phosphorous and sulphur
  10. *    New functional groups
  11.             - Benzene ring and phosphoric acid
  12. *    Multiple delete command
  13. *    Preliminary animation feature
  14.             - Animate from disk or from memory
  15. *    Installation program
  16.             - Set default values and atom display types
  17.  
  18. *    Calculate van der Waals energy
  19. *    Find minimum conformational energy
  20. *    Display van der Waals and covalent surfaces
  21. *    Display fragment names
  22.  
  23. -------------------------------------------------------------------------------
  24.  
  25.             Preliminary Manual for MolSys v0.73
  26.  
  27. -------------------------------------------------------------------------------
  28.  
  29. © June 1992 Helion Graphics. Written by Robert Mellish & Howard Jones.
  30.  
  31. MolSys v0.73 is shareware and may not be distributed for profit or without 
  32. this text file. All source code, text files and file formats remain 
  33. copyright Helion Graphics. The programmers make no claim for accuracy or 
  34. fitness of purpose for MolSys or any of its related files and documentation.
  35.  
  36. About MolSys ------------------------------------------------------------------
  37.  
  38. MolSys is a molecular modelling package for the Atari ST. It requires a
  39. mono monitor but should run irrespective of memory size. It was developed
  40. from MolView v2.5, MolBuild v0.7 and MolScript v0.1. These programs were
  41. inspired by a PC program written by Alan Mynett and published in the 
  42. October 1987 edition of Personal Computer World.
  43. MolSys is powerful, but quick and easy to learn and use, and is capable of
  44. directly printing output or producing files which may be imported into DTP
  45. packages for inclusion in documents. 
  46. MolSys was written using the Lattice C V5 development package from HiSoft.
  47.  
  48. Limitations of Version 0.73 ---------------------------------------------------
  49.  
  50. MolSys v0.73 contains only a limited animation function, and is also limited to
  51. a maximum of 100 atoms and 16 molecule fragments in memory at one time. To
  52. register for the latest version of MolSys, see the section at the end of this
  53. file. Please register if you like MolSys, and especially if you intend to use
  54. it for any serious work. Registering will encourage me to produce future
  55. versions with more features.
  56.  
  57. Changes From Previous Versions ------------------------------------------------
  58.  
  59. If you have used MolSys before, it will be necessary to re-install MolSys as
  60. the format of the MOLSYS.INF file has changed. More importantly, the format
  61. of MLS (molecule fragment) files has also changed, and so it is necessary to
  62. convert any you have made with previous versions of MolSys into the new format.
  63. This can be done with the supplied program MS_4_5.TTP. See its accompaning text
  64. file for instructions.
  65.   
  66. Installing MolSys -------------------------------------------------------------
  67.  
  68. Configuration of MolSys is done via the MOLSYS.INF file. This file is best
  69. edited by using the supplied installation program, MSI. The supplied INF
  70. file should allow you to run MolSys without need for further installation.
  71. Just double click on MOLSYS.PRG to begin. If you later want to adapt the
  72. installation, follow the instructions below.
  73. You should first copy the MOLSYS.PRG, MOLSYS.RSC, MOLSYS.INF, SYSTEM.FNT,
  74. MSI.PRG and MSI.RSC into the same folder, then double click on MSI.PRG.
  75. After the credit dialogue, you are presented with a menu which allows
  76. you to access a series of dialogue boxes containing options and default
  77. values which you may change.
  78. The first dialogue is the main options. The first editable field is the
  79. file path of the resource file. Normally, this will just be '\', which
  80. will cause the program to search in the current directory. Note that if
  81. the resource file cannot be found, the program will abort.
  82. The second field is the file path and name of the 16x8 screen font to be used
  83. by MolSys. (Usually 'SYSTEM.FNT'). This path and name will also be used when
  84. MolSys loads the replacement 8x8 screen font, but with the extender '.FN8'
  85. substituted (i.e. 'SYSTEM.FN8'). These are optional, and the replacement fonts
  86. will not be used if the 'disabled' button is highlighted. These fonts are
  87. Harlekin format screen fonts.
  88. The third field is the default path of the molecule fragment files.
  89. The forth field is maximum number of atoms which may be added to the
  90. molecule. In this version of MolSys, this number cannot be set greater
  91. than 100. If you register, you will receive a version where the maximum
  92. number of atoms is limited only by available memory. On a 'clean' 520ST
  93. this value can be up to about 3000, which should be adequate for most
  94. purposes. By decreasing this number, it is possible to make more memory
  95. available for animation, ramdisks, print spoolers, desk accessories etc.
  96. The second dialogue is the default values dialogue. This allows the setting
  97. of the default translation distance, rotation angle, zoom level, size of
  98. spheres in reduced size mode and size of sticks in stickmode 3 (thick).
  99. The third dialogue allows the setting of the type of shading used to display 
  100. the various atom types. Clicking on an atom displays the type of shading used.
  101. Click on a shading type to change the display of the selected atom type to
  102. that shade. Note their are two other options which can be changed, 'Colour
  103. Shade' and 'Colour', which control the display of atoms for the colour version
  104. of MolSys. As the colour version is not yet available, these options currently
  105. have no effect.
  106. Clicking on 'Save and Exit' saves the MOLSYS.INF file and exits the program.
  107. Clicking on just 'Exit' exits without saving the file. 
  108.  
  109. Running MolSys ----------------------------------------------------------------
  110.  
  111. The file MOLSYS.INF should be in the current directory when MOLSYS.PRG
  112. is run, i.e. in the same directory as MOLSYS.PRG. On running, the program will
  113. attempt to load MOLSYS.INF and the resource file. If these files cannot be
  114. found the program will abort. It will then attempt to load the fonts, and then
  115. allocate memory for screen buffers and variables. If the program runs out of
  116. memory on loading, try decreasing the maximum number of atoms set.
  117.  
  118. Overview of Terms Used in MolSys ----------------------------------------------
  119.  
  120. In MolSys, a molecule consists of a number of sites and atoms. Atoms are shown
  121. by their chemical symbol (e.g. C,H,O,Cl etc.) and sites are shown by a number
  122. between 0 and 3. Sites are the only place where atoms may be placed. The type
  123. of site shows the type of atoms which may be placed there, 0 means all atoms,
  124. and 1,2 or 3 means only singly, doubly or triply bonded atoms. One of these
  125. sites or atoms will be the current (or marked) site or atom. In build mode,
  126. this site or atom will have a diamond-shaped marker placed around it. If
  127. stick mode is on, bonds between sites and atoms are shown by lines. 
  128. A collection of sites and atoms bonded together forms a molecule fragment.
  129. The fragments currently in memory can be shown on the fragment selector
  130. (see below), where the visibility of fragments can be turned on or off.
  131. One of these fragments will be the current fragment, and its title will appear
  132. at the top of the display. Note that the current fragment does not necessarily
  133. have to contain the current atom. The current fragment is the one on which
  134. normally all manipulations are made.
  135. Throughout MolSys, all distances are expressed in nanometres (1E-9 metres),
  136. and all angles in degrees.
  137.  
  138. Selecting Functions in MolSys ------------------------------------------------
  139.  
  140. When a function icon is selected (or the corresponding keyboard shortcut is
  141. pressed), the icon may invert, which means that further input is required.
  142. For functions such as the freehand rotate and move controls, the mouse cursor
  143. will change to an open hand, and the mouse moved to manipulate the